package cn.tedu.ems.service;

import cn.tedu.ems.pojo.dto.NewsAddNewDTO;
import cn.tedu.ems.pojo.dto.NewsUpdateDTO;
import cn.tedu.ems.pojo.vo.NewsListItemVO;
import cn.tedu.ems.pojo.vo.NewsStandardVO;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

@Transactional
public interface INewsService {
    /**
     * 添加新闻
     *
     * @param newsAddNewDTO 添加新闻
     */
    void addNew(NewsAddNewDTO newsAddNewDTO);

    /**
     * 删除新闻
     *
     * @param id 尝试删除的新闻的id
     */
    void delete(Long id);

    /**
     * 根据新闻id修改新闻数据
     *
     * @param id 新闻id
     * @return 新的新闻数据
     */
    void updateInfoById(Long id, NewsUpdateDTO newsUpdateDTO);

    /**
     * 根据id查询新闻的详情
     *
     * @param id 新闻id
     * @return 匹配的新闻详情，如果没有匹配的数据，则返回null
     */
    NewsStandardVO getStandardById(Long id);

    /**
     * 根据投稿标题查询新闻的详情
     *
     * @param title 投稿标题
     * @return 匹配的新闻详情，如果没有匹配的数据，则返回null
     */
    NewsStandardVO getStandardByTitle(String title);

    /**
     * 查询新闻列表
     *
     * @return 新闻列表
     */
    List<NewsListItemVO> list();

    /**
     * 根据文章标题查询新闻列表
     *
     * @param title 投稿标题
     * @return 新闻列表
     */
    List<NewsListItemVO> listByTitle(String title);

    /**
     * 根据文章作者查询新闻列表
     *
     * @param author 作者名称
     * @return 新闻列表
     */
    List<NewsListItemVO> listByAuthor(String author);

    /**
     * 根据投稿部门查询新闻列表
     *
     * @param submissionDepartment 投稿部门
     * @return 新闻列表
     */
    List<NewsListItemVO> listBySubmissionDepartment(String submissionDepartment);

    /**
     * 根据投稿栏目查询新闻列表
     *
     * @param submissionColumn 投稿栏目
     * @return 新闻列表
     */
    List<NewsListItemVO> listBySubmissionColumn(String submissionColumn);
}
